Skip to content

Fix website accessible-name and color-contrast issues - #43

Merged
sudo-py-dev merged 1 commit into
mainfrom
website-a11y-contrast
Nov 12, 2026
Merged

sudo-py-dev merged 1 commit into
mainfrom
website-a11y-contrast

Conversation

@sudo-py-dev

Copy link
Copy Markdown
Owner

What changed

Fixes two accessibility audit findings on the website, across all six language pages.

Elements must have their visible text as part of their accessible name

  • The header logo link had aria-label="FMX home" while its visible text reads "FMX Free Media Xpress", so voice-control users couldn't target it by what they see.
  • Removed the label so the visible text names the link, and removed the now-unused home translation key from all five catalogs.

Elements must meet minimum color contrast ratio thresholds

  • 11 small text styles were below WCAG AA 4.5:1 (hero micro text, window caption, .mp4 ↗ .mp3 arrow, media-type separators, format tags, "✓ Complete", greeting samples, release status/intro on the downloads band, card details, download note).
  • Darkened 10 colors just enough to pass (~4.6:1 or more), keeping the same hues. Includes a small darkening of --muted (#647068 → #636e66), which was at 4.49:1 on the downloads background.

For reviewers

  • dist/ is regenerated with cargo run --release in website/.
  • Checked every visible text element on all six pages in a browser at desktop width with a contrast script: no failures, no label mismatches. Worth re-running Lighthouse/axe on the preview to confirm.
  • node --test website/tests/i18n.test.js: 6 pass.
  • Follow-up to Improve website SEO with per-language pages and self-hosted fonts #42, which was squash-merged before this fix was pushed; this branch is cut from current main.

🤖 Generated with Claude Code

The header logo link had aria-label "FMX home" while its visible text
reads "FMX Free Media Xpress", so voice-control users could not target
it by what they see. Drop the label (and its unused translation) and
let the visible text name the link.

Darken ten small grey and green text colors so every text element meets
WCAG AA 4.5:1 against its background, keeping the same hues.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 12, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
fmx Ready Ready Preview Nov 12, 2026 9:17am UTC

@coderabbitai

coderabbitai Bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Explain Change →

Caution

Review failed

The pull request is closed.

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@sudo-py-dev
sudo-py-dev merged commit 07f4cf9 into main Nov 12, 2026
9 of 10 checks passed
@sudo-py-dev
sudo-py-dev deleted the website-a11y-contrast branch November 12, 2026 09:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant